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The AIM Mail System at the CIA 


Disclaimer 


My remarks do not necessarily reflect official positions of the 
Central Intelligence Agency or the United States Government. 
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The AIM Mail System at the CIA 


This presentation is not 


A pitch for office automation 
A tutorial in how to do it yourself 
A comparison of electronic mail systems 
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The AIM Mail System at the CIA 

What I will describe 

The way we did it 

What our system does today 

Pitfalls 

Suggestions based upon our experiences 
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The AIM Mail System at the CIA 


The Intelligence Business 


Essentially an information factory 

- information arrives, usually in electronic form 

- information is refined 

- finished product is distributed to our customers 
Computers are analagous to the assembly line 
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The AIM Mail System at the CIA 


Computing Environment 


General Timesharing Service 

- two loosely-coupled VM/CMS systems 

- over 5000 users 

Other timesharing services 

Interfaces to external telecommunications systems 
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The AIM Mail System at the CIA 

Objectives 

Simple and easy to use by "real people" 

High performance 

Extensible 

Capable of handling official correspondence 
Full support for smart glass teletypes 
Secure 
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The AIM Mail System at the CIA 


Implementation Approach 

Central database virtuals 

User virtuals for document creation, editing, display 
and management 
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The AIM Mail System at the CIA 


PROC System 


Facility to support development of complex, assembly language 
system facilities 

Macro and text libraries 

- structured macros 

- stack oriented 

- multitasking 

- interprocess communication (VMCF) 

Available through Waterloo library 
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The AIM Mail System at the CIA 


Folders 


Identifer - name 

Standard user folders 

- INBOX incoming mail 

- WORK work in process 

- OUTBOX outgoing mail 

User defined folders 

Lettered "folders" - accessed minidisks 

System folders 

Folder sharing - GET, PUT and ALL accesses 
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Tho AIM Mail Syr/tem at the CIA 


Documents 


Identifiers 

- category (MEMO, LETTER, etc) 

- name 

- ordinal reference 
Routing 

- FROM originator other than creator 

- THRU individuals whose concurrence is required 

in sequence before document is released 

- TO recipients of "action" copies 

- CC recipients of "information" copies 
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The AIM Mail System at the CIA 


Documents 


Attributes set by user 

- subject 

- routing 

- classification 

- codewords 

- user defined keywords 

- EYES ONLY 

- password 

Attributes set by system 

- sent / not sent 

- seen / not seen 

- various file system data elements, such as the date 
the document was created, the number of records, etc. 
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The AIM Mail System at the CIA 
Frequently Used Commands 


LIST 

DISPLAY 

PRINT 

EDIT 

SEND 

REPLY 

FORWARD 

QUERY 

ERASE 

MOVE 


list documents or folders 

view a document 

print a document on an OS/6 

create or alter a document using a local editor 

- limited support for XEDIT 

send a new document 

- create a new document using the model facility 
if necessary 

create a document in response to another 
route a document to the next addressee(s) 
display the status of documents and the system 
get rid of this copy of a document 
copy a document from one folder to another 
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The AIM Mail System at the CIA 

Other System Commands 


CREATE 

create a new document or folder 

COPY 

copy documents from one folder to another 

DUPLICATE 

create a duplicate copy of a document in 
another folder 

USE 

logically group folders 

MONITOR 

request notification when events occur 

ACCESS 

designate search sequences for system folders 

OPEN 

explicitly open a folder 

CLOSE 

explicitly close a folder 

FOLDER 

designate who may access a folder 

HELP 

display online documentation 
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The AIM Mail System at the CIA 

Simplicity vs. Flexibility 


Models 

- EXEC-like templates 

Aliases 

- nicknames 

System folders 
System Administrators 
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The AIM Mail System at the CIA 


Data Integrity 

File structure 
Database backup 
SEND recovery 
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The AIM Mail System at the CIA 


Database 


Initial approach 

- CMS file system 

- utterly breaks down with 20,000+ files/minidisk 

Current technique 

- block I/O 

- CMS minidisks (formatted IK) with all space reserved 


disk # I block # 
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The AIM Mail System at the CIA 

File Structure 
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The AIM Mail System at the CIA 

Database Structure 
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The AIM Mail System at the CIA 

Ftle Integrity 
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The AIM Mail System at the CIA 

File Handler 


Requests 

- GET / PUT 

- file identifer (disk and block numbers) 
Returns 

- data to local queue 

- data to user queue (blocked 4K) 

Less than 5% of calls are writes 
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The AIM Mail System at the CIA 


Backup 

Transaction for complete data recovery 
Dual database for quick recovery 
Only database writes logged 
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The AIM Mail System at the CIA 

Backup Structure 
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The AIM Mail System at the CIA 

Database Virtual Task Structure 

OPEN get a folder directory 

GET read a document 

PUT file a document 

Other commands 
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The AIM Mail System at the CIA 

User Virtual Task Structure 

' A. 

Main task process all commands 
File handler GET / PUT files 
IMACOM update directory 
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The AIM Mail System at the CIA 

Interpreter 


Variables 

- simple: single line 

- complex: multiple-line 

Keywords recognized by system 
Commands to interpreter 
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The AIM Mail System at the CIA 


Interpreter Variables and Commands 


SYSUSER 

SYSCMD 

SYSDATE 

SYSMNTH 

SYSNDAT 

SYSDAY 

SYSDATI 

SYSJUL 

SYSREV 

SYSOD 

SYSST 

SYSSU 

SYSCHND 

SYSCHNU 

TEMP001 

TEMP002 

POSTAL 

REJECT 

REPLYTH 

REF 

PROMPT 

RETCODE 

SYSFOLD 

SYSF1 

SYSLEN 

SYSHTXT 

SYSALI 

RESET 

TO 

CC 

CORD 

BCC 

PRIV 

LEVEL 

RECEIPT 

READ 

CAMREAD 

TYPE 

AUDIT 

SEDIT 

CONTROL 

COMMENT 

IF 

ELSE 

DO 

DOEXIT 

CASENTR 

CASE 

TEXT 

ENDTEXT 

INPUT 

INSERT 


SYSNAME 

SYSDOC 

SYSNDAY 

SYSYEAR 

SYSTIME 

SYSTI24 

SYSDAT2 

SYSCLAS 

SYSOU 

SYSSD 

SYSEEND 

SYSEENU 

SUBJECT 

TEMP 

TEMP003 

CLASS 

REPLYTO 

REPLYCC 

KEYWORD 

CODEWRD 

SYSNUM 

SYSEVAL 

SYSF2 

SYSLINE 

SYSCASE 

SYSWHO 

SYSSTRG 

SYSPARS 

THRU 

FROM 

AS 

AT 

RETAIN 

PRTY 

CALL 

SYSFILE 

MTYPE 

STACK 

COPY 

ALIAS 

QUIT 

ENDIF 

DONEXT 

ENDDO 

CASELSE 

ENDCASE 

PROC 

ENDPROC 

EXIT 

QUIT 
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The AIM Mail System at the CIA 

Typical Model 


&if &syscmd eq FILE or &sy8cmd eq SAVE 
&subject='Note Model:' 

&exit 

&endif 

&type 

&call a$cla86 

&&class = &sysclas,&sy8htxt(8iclass) 

&type 

&call bSadrs to text nomultl prompt error verify default 
&type 

8tcall a$subjct 

&&subject — &sy8htxt(&subject) 

&&tempsub«" 'Si&subject' 

&&lf &&syscmd eq DISPLAY 

&&tvpe '&&sysndat from: &&sysname subject: &&tempsub ' 
&&endlf 
&8tack user! 

&if &sysnum(&class) gt 0 
.nf 

.he "(Siclass" 

,fe "frclaae" 

&endif 

DATE: &sysdate 

NOTE TO: &to 

SUBJECT: ^subject 
.nf 

fcmtype ' ' 'Enter Text, or ?' 

&input 

&mtype ' * 'DOCUMENT ACCEPTED. PLEASE WAIT ...* 

Central Intelligence Agency 
Office of Data Processing 


02/23/83 

AIM-36 


Sanitized Copy Approved for Release 2010/06/07 : CIA-RDP85-00142R000300200009-0 



Sanitized Copy Approved for Release 2010/06/07 : CIA-RDP85-00142R000300200009-0 

The AIM Mail System at the CIA 

System Directory 

Userid 

Name 

Telephone number 

System 

Privileges 
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The AIM Mail System at the CIA 


System Control Commands 


USER 

INFO 

DIRECTORY 

SHUTDOWN 


display current and maximum number of users 
display system performance statistics 
update system directory 
terminate the system 
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The AIM Mail System at the CIA 

Performance 


Bottlenecks 

- paging 
-I/O 

- processor 
VMCF not a culprit 
Users 

- as many as 30 concurrently 

- about 300 unique users daily 

- over 1,000 in directory 
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The AIM Mail System at the CIA 


Performance Statistics 


AIMSYS INFO Command* 

CNTRL101 HAS BEEN UP FOR 0 DAYS, 13 HOURS, 57 MINUTES, 7 SECONDS 
4% ACTIVE 11% VMCF WAIT 63% I/O WAIT 
1020 OPENS, 630 (62%) DEFERRED 

82571 READS, 63127 (76%) FROM DISK 8055 WRITES, 7334 (91%) TO DISK 
20% STORAGE UTILIZATION 10 MAX USERS 
65982 LOCKS REQUESTED, 253 (0%) WAITED 

(*) figures were collected on the day of the blizzard 
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The AIM Mail System at the CIA 

User Acceptance 

Used by management 
User documentation 
User training 
User demands 
New services 
Improved performance 
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The AIM Mail System at the CIA 


Development Effort 


Scope of effort 

- concept in 1978 

- development begun in 1979 as a back-burner project 

- full-scale development in 1980 

- restricted version available for testing in 1981 

- production in 1982 

Software 

- 580 modules, 88K lines of code in user virtual 

- 185 modules, 43K lines of code in central virtual 
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The AIM Mail System at the CIA 

Dependencies 


Control Program 

- three local diagnoses (optional) 

Conversational Monitor System 

- block I/O 

- enhanced abend recovery (optional) 
Waterloo Script 

Local editor 
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The AIM Mail System at the CIA 


Electronic Mail vs. Word Processing 


Many users find command-based, interactive systems unfriendly 
and frightening 

Our customers are willing to put a computer terminal or a word 
processor on each desk, but not both 

Connectivity and secure sharing of data is a problem with most 
word processing systems 


Central Intelligence Agency 02/23/83 

Office of Data Processing aim -44 


Sanitized Copy Approved for Release 2010/06/07 : CIA-RDP85-00142R000300200009-0 



Sanitized Copy Approved for Release 2010/06/07 : CIA-RDP85-00142R000300200009-0 


The AIM Mail System at the CIA 

Host-based Word Processor 

Exploits the intelligence in our standard terminal to provide 
integrated word processing functions to the timesharing 
system user 

An application program that runs under CMS 
Provides a "what you see is what you get editor" 

Uses Waterloo Script in a transparent manner to format text 

Will be integrated with AIM soon 

Looks, feels and tastes like a "typical" word processor 
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The AIM Mail System at the CIA 

Other Advanced Applications 

Trend is toward complex applications that manage the 
screen while interfacing to back-end database systems 

Front-end (user virtual) portions of AIM must co-exist 
in same virtual machine with applications code 

Special monitor to allow limited multitasking 

PL/I interface 
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The AIM Mail System at the CIA 

Future 

Import / Export 

Multiple central database virtuals 
Multiple VM systems 
Spelling checkers 
Calendars, schedules, reminders 
Event support, timers 
Archiving 
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